home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u108.dms / u108.adf / 200 / 200
Text File  |  1987-06-04  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. SONIXPEEK(1)              USER COMMANDS              SONIXPEEK(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      SonixPeek - lists instruments in Aegis Sonix scores
  10.  
  11. SYNOPSIS
  12.      SonixPeek {-h} {-i} {-n} {-ofile} {-xdirectory} file ...
  13.  
  14. DESCRIPTION
  15.      SonixPeek is a utility designed to make it  easier  to  move
  16.      score files from the Aegis Sonix music package from one disk
  17.      to another. The problem arises because a single Sonix  score
  18.      can use many different instruments, and all of these instru-
  19.      ments must be moved along with the score  file  to  the  new
  20.      disk.
  21.  
  22.      The filename you give SonixPeek should  be  the  name  of  a
  23.      Sonix  score  file.   If  you  don't  specify any additional
  24.      options, it just scans that file building a list of all  the
  25.      instruments found, and then outputs this list to the screen.
  26.  
  27.      If you specify a directory instead of a file, then SonixPeek
  28.      scans all the score files in that directory, building a list
  29.      of instruments in each file. When it's finished, it  outputs
  30.      this  list,  minus duplicates. This lets you see the minimum
  31.      set of instruments you need to have available to play all of
  32.      those scores.
  33.  
  34.      You can include more than one file and/or directory  on  the
  35.      command  line.   In this case, all the files and directories
  36.      included are scanned.
  37.  
  38.      SonixPeek has a number of options which can be used to alter
  39.      its behaviour.  These are as follows:
  40.  
  41.      -h  Normally, SonixPeek outputs a header at the  start  of
  42.          the list of instruments, showing which files the instru-
  43.          ments come from. This option stops the header from being
  44.          printed.
  45.  
  46.      -i  This option makes SonixPeek prompt you  for  confirma-
  47.          tion  for each score file it finds, before including its
  48.          instruments in the instrument list.  This is  useful  if
  49.          you  have a directory containing a large number of score
  50.          files, and you want to find out the instruments in about
  51.          half  of  them,  since  it saves you having to type each
  52.          name out seperately.
  53.  
  54.      -n  SonixPeek normally prints out a list of files  scanned
  55.          and instruments found as it is building the main instru-
  56.          ment list (unless only a single file  was  specified  on
  57.          the command line). This option suppresses the list.
  58.  
  59.      -oF This option makes SonixPeek output the  final  list  of
  60.  
  61.  
  62.  
  63. Copyright Eddy Carroll 1989
  64.         Last change: AMIGA Programmer's Manual            1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. SONIXPEEK(1)              USER COMMANDS              SONIXPEEK(1)
  72.  
  73.  
  74.  
  75.          instruments  to the file F, rather than standard output.
  76.          This provides an  alternative  to  redirecting  standard
  77.          output  with >F. There is a small difference between the
  78.          two however - the list of files mentioned in the discus-
  79.          sion  of  -n is always sent to standard output, so using
  80.          -o has no effect on it.
  81.  
  82.      -xD This option can be used to  help  simplify  moving  the
  83.          instruments  for  a  set of scores to another disk. When
  84.          specified, SonixPeek outputs a script file suitable  for
  85.          use  with  AmigaDOS's  EXECUTE command. This script file
  86.          copies all the instruments  for  the  files  scanned  to
  87.          directory  D.  Before  executing  the  script  file, you
  88.          should change your current directory  to  the  directory
  89.          where all the instrument files are stored.
  90.  
  91.      You can get a brief summary  of  the  options  available  by
  92.      invoking SonixPeek with no parameters. CTRL-C can be used to
  93.      abort SonixPeek at any time.
  94.  
  95. CAVEATS
  96.      There is one small problem with the  automatic  script  file
  97.      facility.  Aegis  Sonix  supports  two kinds of instruments,
  98.      synthesised and sampled. Both types are stored in  a  .instr
  99.      file,  but  sampled  instruments also have an associated .ss
  100.      file. Since SonixPeek has no way of knowing whether a  given
  101.      instrument  is  sampled  or  synthesised,  it  doesn't  know
  102.      whether there is a .ss file that needs to be copied.
  103.  
  104.      The solution is less than elegant but  it  works;  SonixPeek
  105.      assumes  that  ALL instruments have a .ss file, and sets the
  106.      failat level for the script file such that any copy commands
  107.      which fail don't make the script file abort. The only alter-
  108.      native to this would be to allow an instrument directory  to
  109.      be  specified as an option, and it would then be possible to
  110.      determine what type each instrument was. This seems too much
  111.      like hard work :-)
  112.  
  113. AUTHOR
  114.      Eddy Carroll
  115.      The Old Rectory,
  116.      Delgany, Co. Wicklow,
  117.      Ireland.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Copyright Eddy Carroll 1989Last change: AMIGA Programmer's Manual            2
  130.  
  131.  
  132.  
  133.